Lookerベスト・プラクティス：持続・保守可能なLookMLの作成術 #looker

「カスタマーストーリー」を支えるツール特集

#ビッグデータ

#ビジネス・アナリティクス

#Looker

しんや

2019.09.17

この記事は公開されてから1年以上経過しています。情報が古い可能性がありますので、ご注意ください。

Lookerではトピック毎のベストプラクティスを個別にドキュメントやナレッジベースとしてまとめています。当エントリではその中から、『持続・保守可能なLookMLの作成術』についてご紹介したいと思います。

Best Practice: Writing Sustainable, Maintainable LookML – Looker Help Center

全てのLookMLファイルで文字列置換演算子($)を使いましょう。LookMLモデルには、物理データモデル内のオブジェクトへの単一の参照ポイントのみが必要です。後続の定義でオブジェクトを参照する必要が出てきた場合は、既に定義されているLookMLオブジェクトを参照して使いましょう。

`${TABLE}.field_name`の使用

${TABLE}.field_nameは、元になるデータベースの列から直接データを引っ張ってくる全てのベースディメンションに対して、元となるデータベーステーブルを参照するときに利用出来ます。スキーマまたはテーブル名が変更された場合、この値を使っていれば開発者はsql_table_nameというパラメータのスキーマ名またはテーブル名を更新することでその変更に追従し、コードに反映させることが出来ます。
- sql_table_name (for Views)

`${field_name}`の使用

${field_name}は、LookML内で既に定義されているディメンションまたはメジャーを参照する場合に利用出来ます。列名が変更された場合、その変更はベースディメンションまたはメジャーのsqlパラメータでのみ更新する必要があります。その変更は列を参照する他の全てのフィールドに自動的に伝播します。
- sql (for Fields)
例えば、データベース列名がusersidからusers_idに変更された場合、Looker内で参照を変更する必要が出てきますが、${field_name}を使うことでその対応が1行だけで済むようになります。

実践例

複数のディメンションとメジャーが${TABLE}.field_nameで既存のLookMLフィールドを参照する場合、多くの変更が必要となります。

dimension: usersid {
  type: number
  sql: ${TABLE}.usersid ;; # Change here
}

measure: this_week_count {
  type: count_distinct
  sql: ${TABLE}.usersid ;; # Change here
  filters: {
    field: created_date
    value: "7 days"
  }
}

measure: this_month_count {
  type: count_distinct
  sql: ${TABLE}.usersid ;; # Change here
  filters: {
    field: created_date
    value: "1 month"
  }
}

$ {field_name}参照を利用すると、変更は1箇所だけで済みます。

dimension: usersid {
  type: number
  sql: ${TABLE}.usersid ;; # Change here
}

measure: this_week_count {
  type: count_distinct
  sql: ${usersid} ;;       #Using ${field_name} to reference the LookML field `usersid`
  filters: {
    field: created_date
    value: "7 days"
  }
}

measure: this_month_count {
  type: count_distinct
  sql: ${usersid} ;;       #Using ${field_name} to reference the LookML field `usersid`
  filters: {
    field: created_date
    value: "1 month"
  }
}

文字列置換演算子($)のその他の用途については、下記ドキュメントをご参照ください。

SQLの組み込みとLookMLオブジェクトの参照

セット(Set)の利用

モデル(Model)内で再利用可能なフィールドの一覧を維持するために、セット(Set)パラメータを使いましょう。

繰り返されるフィールドのリストは、フィールドリストを更新したり、フィールド参照を変更したりできるモデル内の単一の場所を作成するために、fieldsパラメーターを介して、またはドリルフィールド内のセット(Set)に順番に組み込んでいく必要があります。セット(Set)の詳細については以下ドキュメントをご参照ください。